curl --request POST \
--url https://api-sandbox.mf-atlas.space/api/broker-changes/v1/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"amc_code": "<string>",
"auth_mode": "<string>",
"folio_no": "<string>",
"investor_id": "<string>",
"broker_code": "<string>",
"client_ref": "<string>",
"email": "<string>",
"euin": "<string>",
"holder_name": "<string>",
"mobile": "<string>",
"ria_code": "<string>",
"sub_broker_code": "<string>",
"two_fa_channel": "<string>"
}
'import requests
url = "https://api-sandbox.mf-atlas.space/api/broker-changes/v1/"
payload = {
"amc_code": "<string>",
"auth_mode": "<string>",
"folio_no": "<string>",
"investor_id": "<string>",
"broker_code": "<string>",
"client_ref": "<string>",
"email": "<string>",
"euin": "<string>",
"holder_name": "<string>",
"mobile": "<string>",
"ria_code": "<string>",
"sub_broker_code": "<string>",
"two_fa_channel": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
amc_code: '<string>',
auth_mode: '<string>',
folio_no: '<string>',
investor_id: '<string>',
broker_code: '<string>',
client_ref: '<string>',
email: '<string>',
euin: '<string>',
holder_name: '<string>',
mobile: '<string>',
ria_code: '<string>',
sub_broker_code: '<string>',
two_fa_channel: '<string>'
})
};
fetch('https://api-sandbox.mf-atlas.space/api/broker-changes/v1/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-sandbox.mf-atlas.space/api/broker-changes/v1/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'amc_code' => '<string>',
'auth_mode' => '<string>',
'folio_no' => '<string>',
'investor_id' => '<string>',
'broker_code' => '<string>',
'client_ref' => '<string>',
'email' => '<string>',
'euin' => '<string>',
'holder_name' => '<string>',
'mobile' => '<string>',
'ria_code' => '<string>',
'sub_broker_code' => '<string>',
'two_fa_channel' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api-sandbox.mf-atlas.space/api/broker-changes/v1/"
payload := strings.NewReader("{\n \"amc_code\": \"<string>\",\n \"auth_mode\": \"<string>\",\n \"folio_no\": \"<string>\",\n \"investor_id\": \"<string>\",\n \"broker_code\": \"<string>\",\n \"client_ref\": \"<string>\",\n \"email\": \"<string>\",\n \"euin\": \"<string>\",\n \"holder_name\": \"<string>\",\n \"mobile\": \"<string>\",\n \"ria_code\": \"<string>\",\n \"sub_broker_code\": \"<string>\",\n \"two_fa_channel\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api-sandbox.mf-atlas.space/api/broker-changes/v1/")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"amc_code\": \"<string>\",\n \"auth_mode\": \"<string>\",\n \"folio_no\": \"<string>\",\n \"investor_id\": \"<string>\",\n \"broker_code\": \"<string>\",\n \"client_ref\": \"<string>\",\n \"email\": \"<string>\",\n \"euin\": \"<string>\",\n \"holder_name\": \"<string>\",\n \"mobile\": \"<string>\",\n \"ria_code\": \"<string>\",\n \"sub_broker_code\": \"<string>\",\n \"two_fa_channel\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-sandbox.mf-atlas.space/api/broker-changes/v1/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"amc_code\": \"<string>\",\n \"auth_mode\": \"<string>\",\n \"folio_no\": \"<string>\",\n \"investor_id\": \"<string>\",\n \"broker_code\": \"<string>\",\n \"client_ref\": \"<string>\",\n \"email\": \"<string>\",\n \"euin\": \"<string>\",\n \"holder_name\": \"<string>\",\n \"mobile\": \"<string>\",\n \"ria_code\": \"<string>\",\n \"sub_broker_code\": \"<string>\",\n \"two_fa_channel\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"amc_code": "<string>",
"auth_mode": "<string>",
"created_at": "<string>",
"folio_no": "<string>",
"id": "<string>",
"investor_id": "<string>",
"pan": "<string>",
"status": "<string>",
"updated_at": "<string>",
"broker_code": "<string>",
"client_ref": "<string>",
"euin": "<string>",
"provider_remark": "<string>",
"ria_code": "<string>",
"sub_broker_code": "<string>",
"two_fa_channel": "<string>"
}[BETA] Request broker change
BETA. Files a change-of-broker request for an existing folio with the exchange. Wet-signature requests then need the signed form uploaded via POST //image.
curl --request POST \
--url https://api-sandbox.mf-atlas.space/api/broker-changes/v1/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"amc_code": "<string>",
"auth_mode": "<string>",
"folio_no": "<string>",
"investor_id": "<string>",
"broker_code": "<string>",
"client_ref": "<string>",
"email": "<string>",
"euin": "<string>",
"holder_name": "<string>",
"mobile": "<string>",
"ria_code": "<string>",
"sub_broker_code": "<string>",
"two_fa_channel": "<string>"
}
'import requests
url = "https://api-sandbox.mf-atlas.space/api/broker-changes/v1/"
payload = {
"amc_code": "<string>",
"auth_mode": "<string>",
"folio_no": "<string>",
"investor_id": "<string>",
"broker_code": "<string>",
"client_ref": "<string>",
"email": "<string>",
"euin": "<string>",
"holder_name": "<string>",
"mobile": "<string>",
"ria_code": "<string>",
"sub_broker_code": "<string>",
"two_fa_channel": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
amc_code: '<string>',
auth_mode: '<string>',
folio_no: '<string>',
investor_id: '<string>',
broker_code: '<string>',
client_ref: '<string>',
email: '<string>',
euin: '<string>',
holder_name: '<string>',
mobile: '<string>',
ria_code: '<string>',
sub_broker_code: '<string>',
two_fa_channel: '<string>'
})
};
fetch('https://api-sandbox.mf-atlas.space/api/broker-changes/v1/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-sandbox.mf-atlas.space/api/broker-changes/v1/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'amc_code' => '<string>',
'auth_mode' => '<string>',
'folio_no' => '<string>',
'investor_id' => '<string>',
'broker_code' => '<string>',
'client_ref' => '<string>',
'email' => '<string>',
'euin' => '<string>',
'holder_name' => '<string>',
'mobile' => '<string>',
'ria_code' => '<string>',
'sub_broker_code' => '<string>',
'two_fa_channel' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api-sandbox.mf-atlas.space/api/broker-changes/v1/"
payload := strings.NewReader("{\n \"amc_code\": \"<string>\",\n \"auth_mode\": \"<string>\",\n \"folio_no\": \"<string>\",\n \"investor_id\": \"<string>\",\n \"broker_code\": \"<string>\",\n \"client_ref\": \"<string>\",\n \"email\": \"<string>\",\n \"euin\": \"<string>\",\n \"holder_name\": \"<string>\",\n \"mobile\": \"<string>\",\n \"ria_code\": \"<string>\",\n \"sub_broker_code\": \"<string>\",\n \"two_fa_channel\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api-sandbox.mf-atlas.space/api/broker-changes/v1/")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"amc_code\": \"<string>\",\n \"auth_mode\": \"<string>\",\n \"folio_no\": \"<string>\",\n \"investor_id\": \"<string>\",\n \"broker_code\": \"<string>\",\n \"client_ref\": \"<string>\",\n \"email\": \"<string>\",\n \"euin\": \"<string>\",\n \"holder_name\": \"<string>\",\n \"mobile\": \"<string>\",\n \"ria_code\": \"<string>\",\n \"sub_broker_code\": \"<string>\",\n \"two_fa_channel\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-sandbox.mf-atlas.space/api/broker-changes/v1/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"amc_code\": \"<string>\",\n \"auth_mode\": \"<string>\",\n \"folio_no\": \"<string>\",\n \"investor_id\": \"<string>\",\n \"broker_code\": \"<string>\",\n \"client_ref\": \"<string>\",\n \"email\": \"<string>\",\n \"euin\": \"<string>\",\n \"holder_name\": \"<string>\",\n \"mobile\": \"<string>\",\n \"ria_code\": \"<string>\",\n \"sub_broker_code\": \"<string>\",\n \"two_fa_channel\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"amc_code": "<string>",
"auth_mode": "<string>",
"created_at": "<string>",
"folio_no": "<string>",
"id": "<string>",
"investor_id": "<string>",
"pan": "<string>",
"status": "<string>",
"updated_at": "<string>",
"broker_code": "<string>",
"client_ref": "<string>",
"euin": "<string>",
"provider_remark": "<string>",
"ria_code": "<string>",
"sub_broker_code": "<string>",
"two_fa_channel": "<string>"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Broker change
AMC (fund house) code of the folio, max 3 characters.
TWO_FACTOR | WET_SIGNATURE. WET_SIGNATURE requires uploading the signed form via POST /api/broker-changes/v1/{id}/image.
Existing folio whose distributor is being changed.
Friendly investor ID; its PAN is the primary-holder PAN on the filing.
New distributor ARN, e.g. ARN-12345. Required unless ria_code is given.
Primary holder email. Required for WET_SIGNATURE.
Max 7 characters.
Primary holder name as on the folio, max 40 characters.
Primary holder mobile, max 15 characters.
New RIA code. Required when the investor moves to an RIA instead of an ARN.
MOBILE | EMAIL | BOTH. Required for TWO_FACTOR.
Response
Filed request
Masked.
PENDING_DOCUMENT (wet-signature form not yet uploaded) | SUBMITTED | REJECTED.